home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / howmch07.zip / HOWMUCH.DOC next >
Text File  |  1989-03-04  |  5KB  |  110 lines
  1.  
  2.               ┌──────────────────────────────────────────┐
  3.               │                                          │
  4.               │              HOWMUCH V0.7                │
  5.               │                                          │
  6.               │    A FrontDoor* Mail cost info utility   │
  7.               │                                          │
  8.               │          by Mike Janke 1:135/4           │
  9.               │                                          │
  10.               └──────────────────────────────────────────┘
  11.  
  12.  
  13. NOTE: This program is still in its development stages and should be
  14.       considered a beta version.  I use it daily and it appears to
  15.       be functioning as desired, but please exercise safe computing
  16.       and always have a backup.
  17.  
  18.  
  19. What it is -
  20.  
  21. HOWMUCH is a little program I wrote so I could keep track of how much
  22. money I've spent on net/echomail.  If you use PcPursuit exclusively, or
  23. you don't use cost values in your nodelist that relate to actual cost,
  24. this program will be of little use to you.
  25.  
  26. HOWMUCH uses FrontDoor's OUTBOUND.HIS file to obtain the cost info, so
  27. you must have this option enabled to use HOWMUCH.  It doesn't matter how
  28. many days of history you keep because HOWMUCH places a marker record in
  29. outbound.his and it always knows where it left off.
  30.  
  31.  
  32. Guarantee -
  33.  
  34. None.  I run it daily in my morning batch file with no problems, but I
  35. cannot accept any responsibility for any problems that may occur after
  36. using HOWMUCH.  If you have a problem with this, please delete all files
  37. related to HOWMUCH and never use it.
  38.  
  39.  
  40. Cost -
  41.  
  42. None.  Howmuch is 100% free.  In addition, there are no registration
  43. requirements of any kind, though an occasional attaboy wouldn't be
  44. refused :-)
  45.  
  46.  
  47. Usage -
  48.  
  49. There are two modes for HOWMUCH.  First is the batch mode.  This
  50. requires you to use a command line switch of "-b" or "/b". Actually,
  51. I'm pretty easy going.  You can use ANYTHING you like as the switch
  52. to signify batch mode. Even "Howmuch Batch" would be just fine. This
  53. mode is used to compile the cost info from outbound.his and add that
  54. info to Howmuch.his.   Howmuch.his is created on the first run and
  55. appended from there on.
  56.  
  57. Howmuch.his has the exact same file format as outbound.his, but each
  58. system is only added to Howmuch.his one time and any new mail costs are
  59. added to that system's total.  Also, no file transfer data is compiled,
  60. only mail cost.
  61.  
  62. The second mode of Howmuch is the display mode.  This displays the data
  63. in Howmuch.his to the screen.  There are no fancy windows or colors,
  64. just net/node info, system name and cumulative cost for that system.
  65. The output is in column format for easy reading and is redirectable so
  66. the output can be sent to a file or printer.
  67.  
  68. So, "HOWMUCH -b" (don't use the quote marks of course) will run HOWMUCH
  69. in it's compile data mode. Howmuch opens outbound.his, looks for a
  70. marker record, and if found, compiles data from that point on.  If no
  71. marker is found, it assumes a new outbound.his and compiles data from
  72. the starting record.  Zero cost records are ignored.  You'd probably
  73. want to use this mode in your morning cleanup batch file.
  74.  
  75. Running "HOWMUCH" without any commandline switch tells Howmuch to
  76. display the contents of Howmuch.his to the screen. This mode works great
  77. with Frontdoor's mailer ALT-F# keys.  There is a pause built in to
  78. Howmuch, but it's only every 20 lines, so you'll want to enable
  79. FrontDoor's "Pause before returning" option in the ALT-F# key setup if
  80. that's how you run HOWMUCH.
  81.  
  82. You may also redirect the output to a file or printer using standard
  83. dos redirection i.e. "Howmuch > filename" or "Howmuch > prn".  If
  84. redirection is detected by Howmuch, the "Press any key to continue" is
  85. disabled and the data is output without interruption.
  86.  
  87.  
  88. Possible problem areas -
  89.  
  90. Howmuch reads FrontDoor's outbound.his into an array for quick
  91. comparisons and compilation of data.  Due to Turbo Pascal's 64k
  92. limitation for a single data item, your first run of Howmuch will
  93. require your outbound.his to be less than 64k (roughly 640 entries
  94. in outbound.his).  This doesn't seem to present any real problems.
  95. Does ANYONE keep a history for that long?
  96.  
  97. If Outbound.his is 63k on your first run and 80k on the second run, all
  98. will be fine.  Howmuch will only have to read in 17k next time due to
  99. the 'marker' inserted during the previous run.
  100.  
  101.  
  102. enjoy.
  103.  
  104.   Mike Janke
  105.  
  106.  
  107. *FRONTDOOR Copyright 1988, 1989 Scandinavian PC Systems and InterZone Software
  108.  
  109.  
  110.